Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 2 - Control Manager Reference / Control Manager Functions

Creating and Removing Controls /

KillControls

CHANGED WITH THE APPEARANCE MANAGER

Removes all controls in a specified window.

pascal void KillControls (WindowPtr theWindow);

theWindow

On input, a pointer to the window whose controls you wish to remove.

DISCUSSION

The KillControls function disposes of all controls associated with the specified window. To remove just one control, use DisposeControl. If an embedding hierarchy is present, KillControls disposes of the controls embedded within a control before disposing of the container control.

SPECIAL CONSIDERATIONS

The Window Manager functions CloseWindow and DisposeWindow automatically dispose of all controls associated with the given window.

SEE ALSO

"Embedding Controls".

WHEN THE APPEARANCE MANAGER IS NOT AVAILABLE

KillControls does not dispose of embedded controls, because embedding hierarchies are not supported.